Add an explanation of attributes. (#349367, Don Anderson)

2006-08-06  Matthias Clasen  <mclasen@redhat.com>

	* gtk/tmpl/gtkcelllayout.sgml: Add an explanation
	of attributes.  (#349367, Don Anderson)

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 6f85b72c1aff2681d0e8118d4418acbff4bd5e1d..63ada866df370cdf32eaa3486a11baa1e1175c66 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,5 +1,8 @@
 2006-08-06  Matthias Clasen  <mclasen@redhat.com>
 
+       * gtk/tmpl/gtkcelllayout.sgml: Add an explanation
+       of attributes.  (#349367, Don Anderson)
+
        * gtk/tmpl/gtkrecentmanager.sgml: Fix a typo.  (#349120, Vincent Untz) 
 
 2006-07-23  Matthias Clasen  <mclasen@redhat.com>

diff --git a/docs/reference/gtk/tmpl/gtkcelllayout.sgml b/docs/reference/gtk/tmpl/gtkcelllayout.sgml
index ee1481bd589b8dc54c68761dd4482c87b3fb9406..d2921225578a32aacd9550da9e41c3fd4f54fd0c 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkcelllayout.sgml
+++ b/docs/reference/gtk/tmpl/gtkcelllayout.sgml
@@ -11,6 +11,18 @@ want to provide a #GtkTreeViewColumn-like API for packing cells, setting
 attributes and data funcs. 
 </para>
 
+<para>
+One of the notable features provided by implementations of GtkCellLayout
+are <emphasis>attributes</emphasis>. Attributes let you set the properties
+in flexible ways. They can just be set to constant values like regular
+properties. But they can also be mapped to a column of the underlying 
+tree model with gtk_cell_layout_set_attributes(), which means that the value 
+of the attribute can change from cell to cell as they are rendered by the 
+cell renderer. Finally, it is possible to specify a function with 
+gtk_cell_layout_set_cell_data_func() that is called to determine the value 
+of the attribute for each cell that is rendered.
+</para>
+
 <!-- ##### SECTION See_Also ##### -->
 <para>